home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-04 / tess_110.zip / TESS-D.ZIP / VER110.DOC < prev   
Text File  |  1988-10-02  |  9KB  |  442 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                TesSeRact(TM)
  10.  
  11.  
  12.         A Library of Routines for Developing Ram-Resident Programs
  13.                                      
  14.                                     and
  15.                                      
  16.         A Proposed Standard for Ram-Resident Program Communication
  17.                                      
  18.                                      
  19.                    Documentation Update for Version 1.10
  20.                               October 2, 1988
  21.                                      
  22.                                      
  23.               Copyright (c) 1988, TesSeRact Development Team
  24.                             All Rights Reserved
  25.      
  26.      
  27.              _______
  28.         ____|__     |               (TM)
  29.      --|       |    |-------------------
  30.        |   ____|__  |  Association of
  31.        |  |       |_|  Shareware
  32.        |__|   o   |    Professionals
  33.      -----|   |   |---------------------
  34.           |___|___|    MEMBER
  35.      
  36.      
  37.  
  38.  
  39.                              Table of Contents
  40.  
  41.  
  42.      Chapter 1.  Introduction........................................2
  43.           Order Form.................................................3
  44.      Chapter 2.  New TesSeRact Library Routine.......................4
  45.           TsRestore2F................................................4
  46.      Chapter 3.  New TesSeRact Multiplex Functions...................5
  47.           TSR Utility Routines.......................................5
  48.                Trigger PopUp (Function 22h)..........................5
  49.                Trigger Background (Function 23h).....................6
  50.      Chapter 4.  Changes to TesSeRact................................7
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                     -1-
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                          Chapter 1.  Introduction
  71.  
  72. This file  contains necessary  update information  for Version  1.10 of the
  73. TesSeRact Library.   Two  new Interrupt  2Fh Multiplex  Functions have been
  74. added, and one additional TesSeRact Library routine has also been added.
  75.  
  76. In addition,  this document  also contains  a listing  of all bugs/problems
  77. repaired since Version 1.00 of the library.
  78.  
  79. Finally, please note our new address:
  80.   
  81.   TesSeRact Development Team
  82.   1657 The Fairways
  83.   Suite 101
  84.   Jenkintown, PA 19046
  85.   
  86.   Phone: 215-884-3373
  87.   CIS: 70731,20
  88.   MCI: 315-5415
  89.   FAX: 215-886-4225
  90.   
  91.   
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                     -2-
  128.  
  129.  
  130.  
  131.  
  132.  
  133.                                         
  134.  
  135.  
  136.  
  137.             TesSeRact(TM) Products Order And Registration Form
  138.  
  139.  
  140.      Registration Number:     ____________________________
  141.      
  142.      Name:          ______________________________________
  143.      
  144.      Address:       ______________________________________
  145.      
  146.                     ______________________________________
  147.      
  148.      City:          ______________________________________
  149.      
  150.      State:         __________________________ Zip: ______
  151.      
  152.      Telephone:     ______________________________________
  153.      
  154.      Item                                      Quantity      Total
  155.      --------------------------------------------------------------
  156.      Registered User Upgrade ($10)_______________________|_________
  157.         (to Version 1.10)
  158.      Upgrade for Registrations after 9/15/88_____________|____0.00_
  159.      TesSeRact Registration ($25 each)___________________|_________
  160.      TesSeRact Source Code License ($25 each)____________|_________
  161.      TesSeRact Trial Disk ($10)__________________________|_________
  162.      Monthly Information NewsLetter______________________|_________
  163.         ($10 per year)
  164.      Product Identification String (Free!!)______________|____0.00_
  165.      Your ID String: ______________ Product Name: ______________
  166.      
  167.      Shipping Charges:     Upgrade Order        Normal Registration
  168.                           U.S.  :  $ 0.00         U.S.  :  $ 0.00
  169.                           Canada:  $ 5.00         Canada:  $10.00
  170.                           Europe:  $10.00         Europe:  $15.00
  171.      Overnight:  $15.00 + Normal Shipping Charge (from above)
  172.      Total Shipping Charges______________________________|_________
  173.      --------------------------------------------------------------
  174.      Total Due:                                          |_________
  175.      
  176.      Preferred Disk Size:  3.5" ____  5.25" ____
  177.      
  178.      Where did you hear about TesSeRact? __________________________
  179.      Primary Language/Compiler: ___________________________________
  180.      
  181.      Mail Completed Form to:
  182.                     TesSeRact Development Team
  183.                     1657 The Fairways
  184.                     Suite 101
  185.                     Jenkintown, PA 19046
  186.  
  187.  
  188.  
  189.  
  190.                                     -3-
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                  Chapter 2.  New TesSeRact Library Routine
  197.  
  198. TsRestore2F -- Restore Interrupt 2Fh to original state
  199.  
  200.   This  function   should  be   called  by   any  program   that   calls
  201.      TsCheckResident() and DOES NOT REMAIN RESIDENT.  Call this function
  202.      BEFORE EXITING THE PROGRAM to ensure that the Interrupt 2Fh handler
  203.      is set to its original default value of 00 00, if necessary.  It is
  204.      not  necessary   to  call   this  routine  if  your  program  calls
  205.      TsDoInit(), or  if your program does not call the TsCheckResident()
  206.      library routine.
  207.  
  208.   Parameters:
  209.      None.
  210.  
  211.   Returns:
  212.      None.
  213.  
  214.   C Language Usage:
  215.   
  216.   extern void far TsRestore2F(void);
  217.  
  218.   Pascal Usage:
  219.   
  220.   procedure TsRestore2F;
  221.  
  222.   Assembler Usage:
  223.   
  224.   EXTRN    TSRESTORE2F:NEAR
  225.   
  226.      call  TSRESTORE2F
  227.   ;
  228.   ; NOTE:  AX, BX and ES registers destroyed
  229.   ;
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.                                     -4-
  254.  
  255.  
  256.  
  257.  
  258.  
  259.                Chapter 3.  New TesSeRact Multiplex Functions
  260.  
  261.  
  262.                            TSR Utility Routines
  263.  
  264.  
  265.  
  266. Trigger PopUp (Function 22h)
  267.  
  268.   This function  hass been added to permit an application to 'trigger' a
  269.      POPUP procedure.   When this call is completed, the TSR will pop up
  270.      at the  earliest opportunity,  just as  if the  TsrStatus flags had
  271.      been manipulated  directly.   TsrMain() will  be called  (if it  is
  272.      save) as  soon as possible, or a TsrBeep() procedure will be called
  273.      to signal the TSR is unable to popup.
  274.  
  275.   Parameters:
  276.      TsrIdNum.................Identification Number of TSR to call
  277.  
  278.   Returns:
  279.      Non-Zero -- Unable to pass pointer -- invalid ID Number
  280.      Zero -- Success
  281.  
  282.   C Language Usage:
  283.   
  284.   extern unsigned far pascal TsTriggerPop(
  285.      unsigned short TsrIdNum
  286.      );
  287.  
  288.   Pascal Usage:
  289.   
  290.   function TsTriggerPop(
  291.      TsrIdNum : word
  292.      ) : word;
  293.  
  294.   Assembler Usage:
  295.   
  296.      mov   ax,5453h
  297.      mov   bx,22h
  298.      mov   cx,TsrIdNum
  299.      int   2fh
  300.   ;
  301.   ;  result returned in AX
  302.   ;
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.                                     -5-
  317.  
  318.  
  319.  
  320.  
  321.  
  322. Trigger Background (Function 23h)
  323.  
  324.   This function  allows  a  program  to  directly  call  the  background
  325.      procedures if it is safe for the background procedure to be called.
  326.      PLEASE USE  CAUTION WHEN  CALLING THIS  FUNCTION!!  It will allow a
  327.      background procedure  to be  called when  INDOS is  set to  1.  The
  328.      purpose  of   this  function   is  to  allow  network  programs  to
  329.      independently signal an idle status.
  330.  
  331.   Parameters:
  332.      TsrIdNum.................Identification Number of TSR to call
  333.  
  334.   Returns:
  335.      Non-Zero -- Unable to pass pointer -- invalid ID Number
  336.      FFFFh -- Not safe to call Background procedure
  337.      Zero -- Success
  338.  
  339.   C Language Usage:
  340.   
  341.   extern unsigned far pascal TsTriggerBack(
  342.      unsigned short TsrIdNum
  343.      );
  344.  
  345.   Pascal Usage:
  346.   
  347.   function TsTriggerBack(
  348.      TsrIdNum : word
  349.      ) : word;
  350.  
  351.   Assembler Usage:
  352.   
  353.      mov   ax,5453h
  354.      mov   bx,23h
  355.      mov   cx,TsrIdNum
  356.      int   2fh
  357.   ;
  358.   ;  result returned in AX
  359.   ;
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.                                     -6-
  380.  
  381.  
  382.  
  383.  
  384.  
  385.                      Chapter 4.  Changes to TesSeRact
  386.  
  387. Critical Error Flag pointer now works correctly under OS/2 1.0.
  388.  
  389. Add check for DOS 4.0.
  390.  
  391. TsSetAdrTP4 now returns with the correct RET instruction.
  392.  
  393. TempParms data area reduced to correct size.
  394.  
  395. INT 21h 'gate' array must fall on EVEN boundary in Turbo Pascal versions.
  396.  
  397. Check to make sure stacks are set on EVEN boundaries.
  398.  
  399. Modified TESSDEMO to work better with MSC.
  400.  
  401. Added Turbo Pascal 5.0 source/unit.
  402.  
  403. Move EXTRN  for user  procedures outside  simplified CODE statement so they
  404. can be called in large-model programs.
  405.  
  406. Change code for INT 16h, Fn 0 to get around XTREE bug that checks the FLAGS
  407. register.
  408.  
  409. Force DOS to use AUXSTACK on INT 21h, Fn 0-12 if popped up from DOS command
  410. line.  'C' programmers can now use getch().
  411.  
  412. Added TsTriggerPop and TsTriggerBack.
  413.  
  414. Added internal function _TESSBACKGROUND to check if safe to call background
  415. procedure.
  416.  
  417. Added TsRestore2F() function; call this internally before releasing TSR!!
  418.  
  419. Fixed problem with popping up over INT 8
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.                                     -7-